home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / os2 / pine391a.zip / README.Os2 < prev   
Text File  |  1996-01-16  |  6KB  |  139 lines

  1. -----------------------------------------------------------------
  2. Installation instructions are in the following section. Please do
  3. not mail the person mentioned at the foot of this document until
  4. and unless you have read this document completely!
  5. -----------------------------------------------------------------
  6.  
  7. This is a port of the Pine 3.91 mail user agent to OS/2 32-bit
  8. compiled with the emx 0.09b development system, gcc 2.7.2. This
  9. includes only the mail UA client and the pico editor, no imapd.
  10.  
  11. Notes on the OS/2 version of Pine:
  12.  
  13.  . This is a text mode only version of Pine.
  14.  
  15.  . Like the PC & Windows versions, this version of Pine is intended
  16.    to be run primarily as a network client.
  17.  
  18.  . The following client mailstream drivers are supported by Pine-OS2:
  19.  
  20.      imap,nntp,pop3,bezrk,tenex,dawz,dummy
  21.  
  22.    This is the same as PC-Pine, with the addition of pop3.
  23.    To enable pop3 over a network link, use the folder
  24.    specification:
  25.  
  26.      {site.domain/pop3}INBOX
  27.  
  28.    The pop3 driver has not been extensively tested, however.
  29.  
  30.    NOTE: Yes, the '{' and '}' are necessary. This is the way that Pine
  31.    knows the difference between a local folder/collection and a remote
  32.    one.
  33.  
  34.  . The "alternate editor" command is active in this version via
  35.    the ^_ key.
  36.  
  37.  . The spell checker is enabled, by default calling gnu ispell.
  38.    Internal spell checking facilities are disabled in Pine, so
  39.    the spell checker itself must provide the interface (as is
  40.    the case with ispell). The "SPELL" environment variable
  41.    can specify an alternative spell checking program.
  42.  
  43.  . All help is included within the executable itself.
  44.  
  45.  . The mouse is enabled and working under OS/2 to the same
  46.    extent as that available under Windows/MSDOS; ie. it works
  47.    for some functions but does not include anything very advanced.
  48.  
  49.  . Unlike the PC versions of Pine, the addressbook functions work.
  50.  
  51.  . Attempts have been made to ensure that all files produced and
  52.    used by Pine conform to 8.3 mapping of the FAT filesystem. It
  53.    has not, however, been tested on FAT. Needless to say, the HPFS
  54.    filesystem is fully supported.
  55.  
  56.  . The pipe command '|' is enabled and functional. Avoid piping
  57.    mail to any interactive command, however - it will not work.
  58.  
  59.  . Printing has not been tested. For expedience, the UNIX model of
  60.    piping output to a command has been used. You may like to use
  61.    the OS/2 port of the BSD lpr command or similar, or pipe to any
  62.    other command according to preference.
  63.  
  64.  . Pine-OS2 maps itself to the current display mode, adapting to
  65.    the current screen size to suit.
  66.  
  67.  . Pine-OS2 provides 16 foreground colours and 8 background colors
  68.    to select from (rather than 8 and 8 with PC-Pine).
  69.  
  70.  . This version of pine is fully UNIX shell aware, and uses the
  71.    SHELL environment variable in preference to COMSPEC when spawning
  72.    other process. This was tested with the csh and ksh ports.
  73.  
  74.  . Debugging is not enabled.
  75.  
  76.  
  77. INSTALLATION
  78.  
  79. Requirements: OS/2 2.x with TCPIP 2.0 or later installed (IBM's IAK is
  80. fine). emx.dll version 0.09b or later placed somewhere in the LIBPATH.
  81.  
  82. NOTE: If you have other OS/2 applications you've downloaded from the
  83. internet or BBSes, then you probably already have emx.dll installed.
  84. Check the file size and date, and if it is not identical or later more
  85. recent than the one supplied in this archive, then you need to update
  86. it. Shut down any and all applications using emx first, else you will
  87. not be able to do so.
  88.  
  89. Set the HOME environment variable in your CONFIG.SYS to a directory you wish
  90. to use for a work area. Reboot. Move Pine.exe (and optionally Pico.exe) to
  91. any directory in the system PATH. Set the TMP and/or TEMP directory to point
  92. to a directory to be used for temporary files. NOTE: This directory must
  93. exist prior running pine or bad things may result. You may use the PINERC
  94. environment variable to point to an alternative configuration file if
  95. necessary.
  96.  
  97. Run Pine. Follow the directions presented, and before doing anything else
  98. you should select S)etup C)onfigure and run through all configuration items
  99. and preferences. You may have to exit and restart to access folders.
  100.  
  101. Read the documentation for further information. Note the syntax of setting
  102. up network folders, folder collections and so on:
  103.  
  104.   Network folder:  {site.domain}path
  105.   News collection: News *{site.domain}[]
  106.  
  107. If you specify 'INBOX' as path, this is magic for the inbound mailbox on the
  108. specified server. Note that over a 14.4K link I've had more luck with using
  109. imap to read news than nntp from a performance point of view. NNTP seems
  110. very slow - imap works better. To set this up:
  111.  
  112.   NNTP-Server: site.domain
  113.   News Collection: News *{site.domain/imap}[]
  114.  
  115. imapd needs to be running on the news server, and you need to have an
  116. account on that machine, of course, otherwise nntp must be used.
  117. Irrespective of which method you use to read mail, nntp is still used for
  118. posting, hence the requirement for the nntp server name.
  119.  
  120. Enjoy!
  121.  
  122. Port to OS/2 by David Nugent (davidn@unique.blaze.net.au)
  123.  
  124.  
  125. CHANGES
  126. ------
  127.  
  128. Release a:
  129.  
  130.   . Fixed keyboard polling problem in Pine (not Pico or within the
  131.     composer, which was ok) - should now not poll the keyboard and
  132.     use lots of CPU unnecessarily.
  133.  
  134.   . Keyboard and video I/O are now threaded. Updating to the screen
  135.     may now be a litle slower on occasion, but performance of the
  136.     program itself, particularly when running in a window on the
  137.     desktop, should be much better.
  138.  
  139.